package com.ruoyi.relationOrder.service;

import java.util.List;

import com.ruoyi.order.domain.Order;
import com.ruoyi.relationOrder.domain.DistributionOrderRelation;

/**
 * 分销订单关联Service接口
 * 
 * @author ruoyi
 * @date 2025-11-07
 */
public interface IDistributionOrderRelationService 
{
    /**
     * 查询分销订单关联
     * 
     * @param relationId 分销订单关联主键
     * @return 分销订单关联
     */
    public DistributionOrderRelation selectDistributionOrderRelationByRelationId(Long relationId);

    /**
     * 查询分销订单关联列表
     * 
     * @param distributionOrderRelation 分销订单关联
     * @return 分销订单关联集合
     */
    public List<DistributionOrderRelation> selectDistributionOrderRelationList(DistributionOrderRelation distributionOrderRelation);

    /**
     * 新增分销订单关联
     * 
     * @param distributionOrderRelation 分销订单关联
     * @return 结果
     */
    public int insertDistributionOrderRelation(DistributionOrderRelation distributionOrderRelation);

    /**
     * 修改分销订单关联
     * 
     * @param distributionOrderRelation 分销订单关联
     * @return 结果
     */
    public int updateDistributionOrderRelation(DistributionOrderRelation distributionOrderRelation);

    /**
     * 批量删除分销订单关联
     * 
     * @param relationIds 需要删除的分销订单关联主键集合
     * @return 结果
     */
    public int deleteDistributionOrderRelationByRelationIds(Long[] relationIds);

    /**
     * 删除分销订单关联信息
     * 
     * @param relationId 分销订单关联主键
     * @return 结果
     */
    public int deleteDistributionOrderRelationByRelationId(Long relationId);


    /**
     * 定时任务：处理待结算的分销订单
     * 每日凌晨执行，将满足条件的"待结算"记录更新为"已可用"状态，并同步更新钱包余额
     */
    public void processSettlementOrders();

    /**
     * 查询分销订单关联列表
     *
     * @param distributionOrderRelation 分销订单关联
     * @return 分销订单关联集合
     */
    public List<DistributionOrderRelation> selectOrderRelationSummaryList(DistributionOrderRelation distributionOrderRelation);

    /**
     * 根据订单ID查询分销关系信息
     *
     * @param orderId 订单主键
     * @return 分销订单关联
     */
    public DistributionOrderRelation selectDistributionOrderRelationByOrderId(Long orderId);

    /**
     * 查询指定分销员的待结算分销订单记录
     * @param distributorId 分销员ID
     * @return 分销订单关联列表
     */
    public List<DistributionOrderRelation> selectPendingRelationsByDistributorId(Long distributorId);


}
